home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / chdir.z / chdir
Encoding:
Text File  |  1998-10-20  |  6.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. cccchhhhddddiiiirrrr((((2222))))                                                              cccchhhhddddiiiirrrr((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_hhhh_dddd_iiii_rrrr, _ffff_cccc_hhhh_dddd_iiii_rrrr - change working directory
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _cccc_hhhh_dddd_iiii_rrrr_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_pppp_aaaa_tttt_hhhh_))))_;;;;
  15.  
  16.      _iiii_nnnn_tttt _ffff_cccc_hhhh_dddd_iiii_rrrr_((((_iiii_nnnn_tttt _ffff_iiii_llll_dddd_eeee_ssss_))))_;;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _cccc_hhhh_dddd_iiii_rrrr and _ffff_cccc_hhhh_dddd_iiii_rrrr cause a directory pointed to by _p_a_t_h or _f_i_l_d_e_s to become
  20.      the current working directory, the starting point for path searches for
  21.      path names not beginning with _////.  _p_a_t_h points to the path name of a
  22.      directory.  The _f_i_l_d_e_s argument to _ffff_cccc_hhhh_dddd_iiii_rrrr is an open file descriptor of a
  23.      directory.
  24.  
  25.      In order for a directory to become the current directory, a process must
  26.      have execute (search) access to the directory.
  27.  
  28.      _cccc_hhhh_dddd_iiii_rrrr will fail and the current working directory will be unchanged if
  29.      one or more of the following are true:
  30.  
  31.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Search permission is denied for any component of the
  32.                          path name.
  33.  
  34.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT              _p_a_t_h points outside the allocated address space of
  35.                          the process.
  36.  
  37.      _EEEE_IIII_NNNN_TTTT_RRRR               A signal was caught during the execution of the _cccc_hhhh_dddd_iiii_rrrr
  38.                          system call.
  39.  
  40.      _EEEE_IIII_OOOO                 An I/O error occurred while reading from or writing
  41.                          to the file system.
  42.  
  43.      _EEEE_LLLL_OOOO_OOOO_PPPP               Too many symbolic links were encountered in
  44.                          translating _p_a_t_h.
  45.  
  46.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG        The length of the _p_a_t_h argument exceeds {_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX},
  47.                          or the length of a _p_a_t_h component exceeds {_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX}
  48.                          while ______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC is in effect.
  49.  
  50.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR             A component of the path name is not a directory.
  51.  
  52.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT              Either a component of the path prefix or the
  53.                          directory named by _p_a_t_h does not exist or is a null
  54.                          pathname.
  55.  
  56.      _EEEE_NNNN_OOOO_LLLL_IIII_NNNN_KKKK             _p_a_t_h points to a remote machine and the link to that
  57.                          machine is no longer active.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. cccchhhhddddiiiirrrr((((2222))))                                                              cccchhhhddddiiiirrrr((((2222))))
  71.  
  72.  
  73.  
  74.      _EEEE_TTTT_IIII_MMMM_EEEE_DDDD_OOOO_UUUU_TTTT           The named file is located on a remote file system
  75.                          which is not available [see _iiii_nnnn_tttt_rrrr_oooo(2)].
  76.  
  77.      _EEEE_MMMM_UUUU_LLLL_TTTT_IIII_HHHH_OOOO_PPPP           Components of _p_a_t_h require hopping to multiple remote
  78.                          machines and file system type does not allow it.
  79.  
  80.      _ffff_cccc_hhhh_dddd_iiii_rrrr will fail and the current working directory will be unchanged if
  81.      one or more of the following are true:
  82.  
  83.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS              Search permission is denied for _f_i_l_d_e_s.
  84.  
  85.      _EEEE_BBBB_AAAA_DDDD_FFFF               _f_i_l_d_e_s is not an open file descriptor.
  86.  
  87.      _EEEE_IIII_NNNN_TTTT_RRRR               A signal was caught during the execution of the
  88.                          _ffff_cccc_hhhh_dddd_iiii_rrrr system call.
  89.  
  90.      _EEEE_IIII_OOOO                 An I/O error occurred while reading from or writing
  91.                          to the file system.
  92.  
  93.      _EEEE_NNNN_OOOO_LLLL_IIII_NNNN_KKKK             _f_i_l_d_e_s refers to a directory on a remote file system
  94.                          and the link to that machine is no longer active.
  95.  
  96.      _EEEE_TTTT_IIII_MMMM_EEEE_DDDD_OOOO_UUUU_TTTT           _f_i_l_d_e_s refers to a directory on a remote file system
  97.                          which is not available [see _iiii_nnnn_tttt_rrrr_oooo(2)].
  98.  
  99.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR             The open file descriptor _f_i_l_d_e_s does not refer to a
  100.                          directory.
  101.  
  102.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT              The directory pointed to by _f_i_l_d_e_s does not exist.
  103.  
  104. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  105.      _cccc_hhhh_rrrr_oooo_oooo_tttt(2).
  106.  
  107. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  108.      Upon successful completion, a value of zero is returned.  Otherwise, a
  109.      value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.